from abc import ABC, abstractmethod
from typing import List, Dict, Any

class BaseRetriever(ABC):
    """检索器基类"""
    
    @abstractmethod
    def get_relevant_documents(
        self,
        query: str,
        **kwargs
    ) -> List[Dict[str, Any]]:
        """
        检索相关文档
        参数:
            query: 查询文本
            **kwargs: 额外参数，包括k（返回文档数量）
        返回:
            相关文档列表
        """
        pass
